ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
 º                                                                          º
 º                               HyperAct, Inc.                             º
 º                               P.O.Box. 5517                              º
 º                         Coralville IA 52241 U.S.A                        º
 º                          Compuserve - 76350,333                          º
 º                        Phone/Fax - (319) 351-8413                        º
 º                                                                          º
 ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ 

*******************************************************************************
*                              3dO Documentation                              *
* Last Update : Feb. 17, 1994.                                                *
*******************************************************************************

*******************************************************************************
*                                INTRODUCTION                                 *
*******************************************************************************

3dO is an object compiler that converts text 3d object definitions into 3d 
object files.

The objects created with the 3dO object compiler can be used by 3d simple
and complex objects load method.

The 3dO program is an alternate way of creating object files, to the method 
that was used up to date, of creating the 3d objects with the 3d program 
(available in another diskette/package).

*******************************************************************************
*                                    USAGE                                    *
*******************************************************************************

At the command line type :

	3DO input[.3dd] [options]

where input.3dd is the name of the object definition source.

The 3dO program will create a 3d object (.3d2) file for each SIMPLEOBJECT
statement from the original source, and a .3DS file for each COMPLEXOBJECT.

C/C++ 3d objects can be created with the /oc+ switch.

*******************************************************************************
*                         OBJECT DEFINITION LANGUAGE                          *
*******************************************************************************

The 3dO program processes a language that is built out of series of statements.

A statement can be specified on multiple lines, if this is the case, a 
continuation mark character MUST be placed at the end of the line. 
The continuation mark line recognized is the '+' (plus) sign.

The SIMPLEOBJECT statement syntax is as follows :

	SIMPLEOBJECT object-name [NOGEN] +
	  POINT point-num x-value y-value z-value +
	  POINT ..... +
	  LINE from-point to-point +
	  LINE ... +
	END-OBJECT

Where object-name is the name of the object file, multiple 3d points can be 
specified with the POINT sub-statement, where point-num is a pointer into the 
3d point array, with x-, y- and z-value the values in the x, y and z dimensions.
Multiple lines are defined using the LINE sub-statement, where from-point and
to-pointsw are pointers into the 3d points array, that describe the edges of 
these lines.
If the optional NOGEN option is specified a stand alone simple object will NOT 
be generated, this is useful if the simple object is used as part of a complex
object.

The COMPLEXOBJECT statement syntax is as follows :

	COMPLEXOBJECT object-name +
	        CHILD child-name [AT x y z] .. +
	END-OBJECT

Where object-name is the name of the complex object that will be generated,
child-name is the name of the simple object that will be inserted as a child
to the complex object. 
The optional AT parameter TRANSLATES (moves) the child object to the requested 
position in the 3D space. (for an example of a complex object definition please
refer to the twopyr.3dd sample file provided with this package).

Please refer to one of the supplied *.3DD files (e.g. twolayer.3dd) for
an example for the usage of this statement.

*******************************************************************************
*                                   General                                   *
*******************************************************************************

3dLIB is distributed by HyperAct, Inc., P.O.Box. 5517 Coralville IA 52241, U.S.A.

3dLIB is (c) copyrighted by Loewy Ron, 1991,93.

3dLIB is a shareware package, please register your copy. To register your copy 
of 3dLIB please refer to the supplied 3DLIB.REG file. 

Other programs distributed by HyperAct, Inc. are described in the supplied 
PROGRAMS.TXT file.

*******************************************************************************
*                                   Contact                                   *
*******************************************************************************

Please contact :

		HyperAct, Inc.  
		P.O.Box 5517
		Coralville IA 52241
		U.S.A

		E-Mail      : Compuserve - 76350,333
		Phone/Fax   : (319) 351-8413
	       
To contact the author directly please write to : 

	       Loewy Ron

		E-Mail      : Compuserve - 100274,162

*******************************************************************************
*                                   Credits                                   *
*******************************************************************************

3dLIB and 3dO were written using Turbo Pascal V6.0, Turbo Pascal for Windows 
V1.5 and Borland Pascal with objects V7.0, trademarks of Borland International.